.de  CW
.sp
.nf
.ft CW
..
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.\" "verbatim" environment (from strace.1)
.de  CE
.ft
.fi
.sp
..
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fakeroot 1 "5 October 2014" "Projecto Debian" "Manual Debian"
.\" Manpage by J.H.M. Dassen <jdassen@debian.org>
.\" and Clint Adams <clint@debian.org>
.SH NOME
fakeroot \- corre um comando num ambiente onde falsifica privilégios de root
para manipulação de ficheiro
.SH SINOPSE
\fBfakeroot\fP \fB[\-l|\-\-lib\fP \fIbiblioteca]\fP \fB[\-\-faked\fP
\fIbinário\-falsificado\fP\fB]\fP \fB[\-i\fP \fIload\-file\fP\fB]\fP \fB[\-s\fP \fIsave\-file\fP\fB]\fP
\fB[\-u|\-\-unknown\-is\-real ]\fP \fB[\-b|\-\-fd\-base ]\fP \fB[\-h|\-\-help ]\fP
\fB[\-v|\-\-version ]\fP \fB[\-\-]\fP \fB[comando]\fP
.SH DESCRIÇÃO
\fBfakeroot\fP corre um comando num ambiente onde aparenta ter privilégios de
root para manipulação de ficheiro. Isto é útil para permitir aos
utilizadores criar arquivos (tar, ar, .deb etc.) com ficheiros dentro com
permissões/posse de root. Sem o \fBfakeroot\fP seria preciso ter privilégios de
root para criar os ficheiros constituintes dos arquivos com as permissões e
posse actuais, e depois empacotá\-los, ou seria preciso construir os arquivos
directamente, sem usar o arquivador.

\fBfakeroot\fP works by replacing the file manipulation library functions
(chmod(2), stat(2) etc.) by ones that simulate the effect the real library
functions would have had, had the user really been root. These wrapper
functions are in a shared library \fB/usr/lib/*/libfakeroot\-*.so\fP or similar
location on your platform.  The shared object is loaded through the
\fBLD_PRELOAD\fP mechanism of the dynamic loader. (See \fBld.so\fP(8))

Se você pretende compilar pacotes com o \fBfakeroot\fP, por favor tente
primeiro compilar o pacote fakeroot: a fase "debian/rules build" tem alguns
testes (testar principalmente por bugs em antigas versões do fakeroot). Se
esses testes falharem (por exemplo porque você tem certos programas da libc5
no seu sistema), os outros pacotes que compile com o fakeroot irão muito
provavelmente falhar também, mas possivelmente de maneiras muito mais
subtis.

Note também que, é melhor não fazer a compilação dos próprios binários sob o
fakeroot. Especialmente o configure e "amigos" não gostam quando o sistema
subitamente comporta\-se de modo diferente do que eles esperam, (ou, eles
aleatoriamente desconfiguram algumas variáveis de ambiente, algumas das
quais o fakeroot precisa).

.SH OPÇÕES
.TP 
\fB\-l\fP \fIbiblioteca\fP, \fB\-\-lib\fP \fIbiblioteca\fP
Especifica uma biblioteca wrapper alternativa.
.TP 
\fB\-\-faked\fP\fI\ binário\fP
Especifica um binário alternativo para usar como falsificado.
.TP 
\fB[\-\-]\fP\fI\ comando\fP
Qualquer comando que deseje corre como fakeroot. Use \(oq\-\-\(cq se no
comando você tem outras opções que podem confundir a análise de opções do
fakeroot.
.TP 
\fB\-s\fP\fI\ save\-file\fP
Guarda o ambiente do fakeroot para o save\-file ao sair. Este ficheiro pode
ser usado para restaurar o ambiente mais tarde usando \-i. No entanto, este
ficheiro irá ter fugas e o fakeroot irá comportar\-se com modos estranhos a
menos que você deixe os ficheiros que foram "mexidos" dentro do fakeroot,
isolados e inalterados quando fora do ambiente. Mesmo assim, isto pode ser
útil. Por exemplo, pode ser usado com o rsync(1) para salvaguardar e
restaurar árvores de directórios inteiras com informações de utilizador,
grupo e dispositivo sem a necessidade de ser root. Veja
\fI/usr/share/doc/fakeroot/README.saving\fP para mais detalhes.
.TP 
\fB\-i\fP\fI\ load\-file\fP
Carrega um ambiente do fakeroot previamente guardado usando \-s a partir de
load\-file. Note que isto não salva implicitamente o ficheiro, use \-s também
para esse comportamento. E seguro usar o mesmo ficheiro para ambos \-i e \-s
numa única invocação do \fBfakeroot\fP.
.TP 
\fB\-u\fP, \fB\-\-unknown\-is\-real\fP
Usa a posse real dos ficheiros anteriormente desconhecida para o fakeroot em
vez de fingir que eles são posse de root:root.
.TP 
\fB\-b\fP\fI\ fd\fP
Especifica a base fd (modo TCP apenas). O fd é o número descritor de
ficheiro mínimo usado para ligações TCP; isto pode ser importante para
evitar conflitos com os descritores de ficheiro usados pelos programas que
correm sob o fakeroot.
.TP 
\fB\-h\fP
Mostra a ajuda.
.TP 
\fB\-v\fP
Mostra a versão.

.SH EXEMPLOS
Aqui está uma sessão exemplo com o \fBfakeroot\fP. Note que dentro do ambiente
de root falso a manipulação de ficheiro que requer privilégios de root tem
sucesso, mas na realidade não está a acontecer.
.CW
$  whoami
joost
$ fakeroot /bin/bash
#  whoami
root
# mknod hda3 b 3 1
# ls \-ld hda3
brw\-r\-\-r\-\-   1 root     root       3,   1 Jul  2 22:58 hda3
# chown joost:root hda3
# ls \-ld hda3
brw\-r\-\-r\-\-   1 joost    root       3,   1 Jul  2 22:58 hda3
# ls \-ld /
drwxr\-xr\-x  20 root     root         1024 Jun 17 21:50 /
# chown joost:users /
# chmod a+w /
# ls \-ld /
drwxrwxrwx  20 joost    users        1024 Jun 17 21:50 /
# exit
$ ls \-ld /
drwxr\-xr\-x  20 root     root         1024 Jun 17 21:50 //
$ ls \-ld hda3
\-rw\-r\-\-r\-\-   1 joost    users           0 Jul  2 22:58 hda3
.CE
Apenas os efeitos que o utilizador \fBjoost\fP podia fazer aconteceram de
verdade.

\fBfakeroot\fP foi especificamente escrito para permitir aos utilizadores
criarem pacotes Debian GNU/Linux (no formato \fBdeb(5)\fP) sem lhes dar
privilégios de root. Isto pode ser feito por comandos como
\fBdpkg\-buildpackage \-rfakeroot\fP ou \fBdebuild \-rfakeroot\fP (na realidade,
\-rfakeroot é predefinição no debuild nos dias que correm, por isso você não
precisa desse argumento).
.SH "ASPECTOS DE SEGURANÇA"
\fBfakeroot\fP é um programa regular, não\-setuid. Não aumenta os privilégios do
utilizador nem baixa a segurança do sistema.
.SH FICHEIROS
\fI/usr/lib/*/libfakeroot\-*.so\fP The shared library containing the wrapper
functions.
.SH AMBIENTE
.IP \fBFAKEROOTKEY\fP
A chave usada para comunicar com o daemon do fakeroot. Qualquer programa
arrancado com o \fBLD_PRELOAD\fP correcto e um \fBFAKEROOTKEY\fP de um daemon em
execução irá ligar\-se automaticamente a esse daemon, e terá a mesma visão
"falsa" das permissões/propriedades do sistema de ficheiros. (assumindo que
o daemon e o programa que se liga foram arrancados pelo mesmo utilizador).
.IP \fBLD_LIBRARY_PATH\fP
.IP \fBLD_PRELOAD\fP
Fakeroot é implementado ao envolver chamadas do sistema. Isto é conseguido
ao definir LD_LIBRARY_PATH=/usr/lib/fakeroot e
LD_PRELOAD=libfakeroot.so.0. Essa biblioteca é carregada antes da biblioteca
C do sistema, e assim a maioria das funções da biblioteca são interceptadas
por ela. Você precisa de definir ou \fBLD_LIBRARY_PATH\fP ou \fBLD_PRELOAD\fP de
dentro de um ambiente fakeroot, deverá ser definido em relação aos caminhos
fornecidos, como em \fBLD_LIBRARY_PATH=$LD_LIBRARY_PATH:/foo/bar/\fP

.SH LIMITAÇÕES
.IP "\fBVersões de biblioteca\fP"
Cada comando executado dentro do \fBfakeroot\fP precisa de ser ligado por link
à mesma versão de biblioteca C do próprio \fBfakeroot\fP.
.IP \fBopen()/create()\fP
O fakeroot não envolve o open(), create(), etc. Então, se o utilizador
\fBjoost\fP também o fizer
.CW
touch foo
fakeroot
ls \-al foo
.CE
ou do outro modo contrário,
.CW
fakeroot
touch foo
ls \-al foo
.CE
No primeiro caso o fakeroot não tem maneira de saber isso, o dono de foo
deverá realmente ser \fBjoost\fP enquanto no segundo caso deveria ter sido
\fBroot\fP. Para o empacotamento de Debian, a predefinição de dar a todos os
ficheiros "desconhecidos" uid=gid=0, está sempre OK. A maneira real para
contornar isto é envolver \fBopen()\fP e \fBcreate()\fP, mas isso cria outros
problemas, como demonstrado pelo pacote libtricks. Este pacote envolvia
muitas mais funções, e tentava fazer muito mais do que o \fBfakeroot
\&.\fP. Aconteceu que uma actualização menor da libc (de um caso em que a função
\fBstat()\fP não usava \fBopen()\fP para um com uma função \fBstat()\fP que usava (em
alguns casos) \fBopen()\fP), veio a causar falhas de segmentação inexplicáveis
(isto é, o \fBstat()\fP da libc6 chamava o \fBopen()\fP envolvido, o qual iria
então chamar a \fBstat()\fP da libc6, etc.). Corrigir isto não foi lá muito
fácil, mas após corrigido, foi apenas uma questão de tempo antes de outra
função passar a usar open(), e esqueçam de tentar portá\-lo para outro
sistema operativo diferente. Assim Eu decidi manter o número de funções
envolvidas pelo fakeroot o mais pequeno possível, para limitar a
possibilidade de \(oqcolisões\(cq.
.IP "\fBconfigure do GNU (e outros programas como tal)\fP"
O fakeroot, efectivamente, está a alterar o modo como o sistema se
comporta. Programas que sondam o sistema como o configure do GNU podem ficar
confusos por isto (ou se não ficarem, podem "stressar" o fakeroot tanto que
o próprio fakeroot possa ficar confuso). Portanto, é aconselhável não correr
o "configure" de dentro do fakeroot. Como o configure deverá ser chamado na
meta "debian/rules build", correr "dpkg\-buildpackage \-rfakeroot" actualmente
toma conta disto.
.SH BUGS
Não envolve open(). Isto não e mau por si próprio, mas se um programa fizer
open("file", O_WRONLY, 000), escrever no ficheiro "file" e o fechar, e
depois tentar abri\-lo para ler o ficheiro, então essa abertura vai falhar,
pois o modo do ficheiro será 000. O bug é tal que se o root fizer o mesmo,
open() irá ter sucesso, pois as permissões não são verificadas para o
root. Eu escolhi não envolver open(), pois open() é usado por muitas outras
funções na libc (mesmo aquelas que já estão envolvidas), assim criando
ciclos viciosos (ou possíveis ciclos futuros, quando a implementação de
várias funções da libc mudarem ligeiramente).
.SH COPIAR
\fBfakeroot\fP é distribuído sob a  GNU General Public License.  (GPL 2.0 ou
superior).
.SH AUTORES
.TP 
joost witteveen
<\fIjoostje@debian.org\fP>
.TP 
Clint Adams
<\fIclint@debian.org\fP>
.TP 
Timo Savola
.SH TRADUTOR
Américo Monteiro <a_monteiro@gmx.com>
.SH "PÁGINA DE MANUAL"
a maioria por J.H.M. Dassen <jdassen@debian.org> Bastantes
modificações/adições por joost e Clint.
.SH "VEJA TAMBÉM"
\fBfaked\fP(1)  \fBdpkg\-buildpackage\fP(1), \fBdebuild\fP(1)
\fB/usr/share/doc/fakeroot/DEBUG\fP

